home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / dmedia / wave.z / wave
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. wwwwaaaavvvveeee((((4444))))                                                                wwwwaaaavvvveeee((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      wave, riff - Microsoft RIFF WAVE file format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The Audio File Library currently supports 13 of the commonly found audio
  16.      file formats, i.e., is able to recognize, read, and write sample data and
  17.      header information to and from files in these formats.  It is important
  18.      not to confuse _s_a_m_p_l_e or _a_u_d_i_o _d_a_t_a _f_o_r_m_a_t_s with _f_i_l_e _f_o_r_m_a_t_s.  The
  19.      former refers to the bit-wise organization of the sound samples in the
  20.      file, i.e., whether the format is 8-bit integer or 16-bit unsigned, etc.
  21.      Audio file format refers to the structure of the _a_u_d_i_o _f_i_l_e _h_e_a_d_e_r, the
  22.      chunk of on-disk data which preceeds the samples and which provides
  23.      information about the file to the audio program.  A single audio file
  24.      format may support a large variety of sample formats.
  25.  
  26.      The MMMMiiiiccccrrrroooossssoooofffftttt RRRRIIIIFFFFFFFF WWWWAAAAVVVVEEEE FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt ((((wwwwaaaavvvveeee)))) was created by Microsoft,
  27.      Inc., as an analog to the AAAAIIIIFFFFFFFF(4) file format.  It consists of a
  28.      variable-length header followed by a contiguous block of binary data
  29.      representing the sound samples.  Occasionally, additional chunks of non-
  30.      audio information will be placed after the sound sample block.
  31.  
  32. DDDDAAAATTTTAAAA FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  33.      SSSSaaaammmmpppplllleeee FFFFoooorrrrmmmmaaaattttssss::::
  34.           Two's complement integer for 9-bit and greater sample widths,
  35.           unsigned for 8-bit and smaller sample widths.
  36.  
  37.      SSSSaaaammmmpppplllleeee WWWWiiiiddddtttthhhhssss::::
  38.           From 1 to 32 bits, inclusive
  39.  
  40.      BBBByyyytttteeee OOOOrrrrddddeeeerrrrssss::::
  41.           Always littleendian (only applies to 9-bit and greater widths)
  42.  
  43.      CCCChhhhaaaannnnnnnneeeellll CCCCoooouuuunnnnttttssss::::
  44.           Any positive nonzero number, 1 and 2 most common
  45.  
  46.      CCCCoooommmmpppprrrreeeessssssssiiiioooonnnn FFFFoooorrrrmmmmaaaattttssss::::
  47.           U-Law (AF_COMPRESSION_G711_ULAW)
  48.  
  49.           A-Law (AF_COMPRESSION_G711_ALAW)
  50.  
  51.           IMA ADPCM (AF_COMPRESSION_DVI_AUDIO)
  52.  
  53.      Note that WAVE ADPCM compression is not currently supported by the Audio
  54.      File Library.
  55.  
  56. FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  57.      WAVE file headers can contain large amounts of additional information.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. wwwwaaaavvvveeee((((4444))))                                                                wwwwaaaavvvveeee((((4444))))
  71.  
  72.  
  73.  
  74.      IIIInnnnssssttttrrrruuuummmmeeeennnntttt CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnnssss::::
  75.           Maximum of 1 allowed.  Any number of loops per inst.  Inst is stored
  76.           in a WAVE 'playlist' containing an arbitrary number of sound
  77.           segments to be played and repeated.  As in an AAAAIIIIFFFFFFFF(4) file, each
  78.           loop contains a reference to a marker (one in the case of WAVE
  79.           rather than two as in AIFF).  Markers are known as 'cue's.  A loop
  80.           is stored as a reference to a starting cue, a length in samples,
  81.           plus a loop count (retrievable via aaaaffffGGGGeeeettttLLLLooooooooppppCCCCoooouuuunnnntttt(3dm)).  Instparams
  82.           associated with this inst:
  83.  
  84.  
  85.           AF_INST_MIDI_BASENOTE
  86.           AF_INST_NUMCENTS_DETUNE
  87.           AF_INST_MIDI_LONOTE
  88.           AF_INST_MIDI_HINOTE
  89.           AF_INST_MIDI_LOVELOCITY
  90.           AF_INST_MIDI_HIVELOCITY
  91.           AF_INST_NUMDBS_GAIN
  92.  
  93.      MMMMaaaarrrrkkkkeeeerrrrssss::::
  94.           Any number of markers (known as 'cues' in WAVE file format) is
  95.           allowed. There must be at least one marker if there are loops
  96.           present in the file. There may be any number of "independent"
  97.           markers (not associated with loops) plus those needed to define the
  98.           starting positions of the loops present (see aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrtttt(3dm) and
  99.           related pages for further information).
  100.  
  101.      In addition, it is possible to associate both a name string and a comment
  102.      string with each marker.  The routines aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee(3dm) and
  103.      aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkCCCCoooommmmmmmmeeeennnntttt(3dm) will do this.
  104.  
  105.      MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss CCCChhhhuuuunnnnkkkkssss::::
  106.  
  107.                AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOPPPPYYYY            copyright string
  108.  
  109.                AAAAFFFF____MMMMIIIISSSSCCCC____AAAAUUUUTTTTHHHH            author string
  110.  
  111.                AAAAFFFF____MMMMIIIISSSSCCCC____NNNNAAAAMMMMEEEE            name string
  112.  
  113.                AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOMMMMMMMMEEEENNNNTTTT         text comment string
  114.  
  115.                AAAAFFFF____MMMMIIIISSSSCCCC____IIIICCCCRRRRDDDD            creation date string
  116.  
  117.                AAAAFFFF____MMMMIIIISSSSCCCC____IIIISSSSFFFFTTTT            software name string
  118.  
  119.  
  120. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  121.      afInitFileFormat(3dm), afGetFileFormat(3dm), afIntro(3dm),
  122.      afInitCompression(3dm), afGetCompression(3dm), afSetLoopStart(3dm),
  123.      afSetLoopEnd(3dm)
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.